|
|
PBGetVolumeInfoAsync |
||||
| Header: | Files.h | Carbon status: | Supported | |
Returns information about a volume as a whole.
void PBGetVolumeInfoAsync (
FSVolumeInfoParam *paramBlock
);
A pointer to a parameter block
The relevant fields of the parameter block are:
On input, a pointer to a completion routine.
On output, the result code of the function.
On input, the volume whose information is to be returned, if volumeIndex is 0. On output, the volume reference number of the volume. This is useful when indexing over all mounted volumes.
On input, the index of the desired volume, or 0 to use the volume reference number in ioVRefNum.
On input, which volume info fields to get and return in the info parameter. If you don’t want the information about the volume returned in the info parameter, set whichInfo to NULL. See also FSVolumeInfo.
On output, the values of the volume info fields. If you don’t want this output, set this parameter to NULL.
On output, the Unicode name. If you don’t want this output, set this parameter to NULL.
On output, the FSRef for the volume’s root directory. If you don’t wish to retrieve this information, set to NULL.
You can specify a particular volume or index through the list of mounted volumes. To get information on a particular volume, set volume to the desired FSVolumeRefNum and set volumeIndex to zero. To index through the list of mounted volumes, set volume to kFSInvalidVolumeRefNum and set volumeIndex to the index (starting at 1).
To get information about the root directory of a volume, you can use FSGetCatalogInfo.
Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)